home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / cmagi83f.zip / README.1ST < prev    next >
Text File  |  1992-04-27  |  8KB  |  210 lines
  1.  
  2.                                ChessMAGIC! v1.83f
  3.                       (c)1991-92 Bud Bradley / KnightWare
  4.                              (All Rights Reserved)
  5.  
  6.  
  7.                                 ██▒▒██▒▒██▒▒██▒▒
  8.                                 ▒▒██▒▒██▒▒██▒▒██
  9.                                 ██▒▒██▒▒██▒▒██▒▒
  10.                                 ▒▒██▒▒██▒▒██▒▒██
  11.                                 ██▒▒██▒▒██▒▒██▒▒
  12.                                 ▒▒██▒▒██▒▒██▒▒██
  13.                                 ██▒▒██▒▒██▒▒██▒▒
  14.                                 ▒▒██▒▒██▒▒██▒▒██
  15.  
  16.  
  17.                                    README.1ST
  18.                                        by
  19.                                    Tom Brady
  20.  
  21.  
  22.                    Thanks for trying ChessMAGIC! on your BBS! 
  23.  
  24.  
  25.                          ╔════════════════════════════╗
  26.                          ║ ATTENTION REGISTERED SITES ║ 
  27.                          ╚════════════════════════════╝
  28.  
  29.     Your 90-day free minor/major update period starts April 27th, 1992, if 
  30.     you registered prior to this date!  We felt this was only fair, since 
  31.     earlier ChessMAGIC! versions were not stable.
  32.  
  33.     If you do not have a current registration key file, call Decibel BBS,
  34.     so you can stay up-to-date!
  35.     
  36.            
  37.                          ============================== 
  38.  
  39.     
  40.     Follow these simple steps to make ChessMAGIC! installation as easy as 
  41.     possible: 
  42.     
  43.     ┌─────────────────────────────────────────────────────────────────────┐
  44.     │                        NEW ChessMAGIC! SETUP                        │
  45.     └─────────────────────────────────────────────────────────────────────┘
  46.  
  47.     1.  If setting up ChessMAGIC! for the first time, create a ChessMAGIC! 
  48.         system directory from which your chess door will be run. 
  49.  
  50.     ┌─────────────────────────────────────────────────────────────────────┐
  51.     │                UPGRADING EXISTING ChessMAGIC! SYSTEM                │
  52.     └─────────────────────────────────────────────────────────────────────┘
  53.  
  54.     1. Delete the CMAGIC.CFG and CMAGIC.ERR files, if upgrading from 
  55.        versions prior to 1.8x series.
  56.  
  57.     ┌─────────────────────────────────────────────────────────────────────┐
  58.     │                       NEW SETUP & ALL UPGRADES                      │
  59.     └─────────────────────────────────────────────────────────────────────┘
  60.  
  61.     2.  Into the ChessMAGIC! system directory, extract all of the archive 
  62.         members from the following self-extracting distribution archives: 
  63.         
  64.                                   CMAGI83F.EXE 
  65.                                   CMSED32A.EXE 
  66.                                   CMSED32B.EXE 
  67.                                   CMSED32C.EXE 
  68.  
  69.         If you do not have all of these archives, you may download whatever 
  70.         you need from Decibel BBS. 
  71.  
  72.     3.  Run INSTALL to compile the CMSED.EXE file.  When properly compiled,  
  73.         the *.00? modules will be deleted. 
  74.         
  75.     4.  Run CMSED.EXE to prepare your ChessMAGIC! system.  This applies to 
  76.         both new and upgrade systems.  CMSED will create any database files 
  77.         that it finds are missing.  No pre-existing data will ever be lost. 
  78.  
  79.     5.  Run UPGRADE to finalize the ChessMAGIC! installation.  This process 
  80.         extracts all file members from the following self-extracting     
  81.         archives: 
  82.                                   cmproto.exe 
  83.                                   cmhelp.exe
  84.                                   misc.exe 
  85.     
  86.         Once the file members have been extracted, these archives will be 
  87.         deleted. 
  88.  
  89.     6.  Now, run LOCAL to test out the new ChessMAGIC! system.  This 
  90.         completes your ChessMAGIC! installation or upgrade!
  91.     
  92.  
  93.     ┌─────────────────────────────────────────────────────────────────────┐ 
  94.     │                     BBS TYPES DIRECTLY SUPPORTED                    │ 
  95.     └─────────────────────────────────────────────────────────────────────┘ 
  96.  
  97.     The following BBS user file formats are DIRECTLY SUPPORTED by the 
  98.     current version of ChessMAGIC!: 
  99.     
  100.            door.sys     - WildCat! v3.x, GAP v5.x, generic & others 
  101.            callinfo.bbs - WildCat! v2.x 
  102.            pcboard.sys  - PCBoard v14.5 & v12.0
  103.            dorinfox.def - RBBS, QBBS & others
  104.            generic.sys  - A simple user system file that ChessMAGIC! can 
  105.                           utilize (not recommended). 
  106.  
  107.        Sample DOOR.BAT for systems using DOOR.SYS format:
  108.  
  109.            d:
  110.            cd \doors\cmagic
  111.        *   cmagic DRIVE\PATH\door.sys
  112.  
  113.        *   NOTE:  If not in your default directory where ChessMAGIC! is run, 
  114.                   you MUST specify the DRIVE\PATH to your system's user file!
  115.  
  116.  
  117.                              ┌─────────────────────┐
  118.                              │     CMPROTO.DAT     │
  119.                              └─────────────────────┘
  120.  
  121.     CMPROTO.DAT will contain the file transfer protocols you wish to make
  122.     available to your users.  You may list up to 10 protocols, one per
  123.     line.  Following the protocol batch/alias information, you will 
  124.     include a comma, then a short protocol description of up to 25 
  125.     characters. 
  126.  
  127.     ChessMAGIC! will pass two parameters:
  128.  
  129.              %1 = port number
  130.              %2 = file name
  131.  
  132.     For several popular protocols, port numbers are defined in the
  133.     environment by using the SET command (e.g. SET DSZPORT=2 for DSZ,
  134.     tells it to use port 2 -- DSZ defaults to using port 1).  However,
  135.     you may specify this parameter in your protocol batch file or
  136.     alias.
  137.  
  138.     The file name being sent to your users by ChessMAGIC! will be
  139.     passed as the %2 parameter.
  140.  
  141.     The distribution archive contains a sample CMPROTO.DAT file and 
  142.     several preconfigured transfer protocol batch files.  The following 
  143.     examples describe use of CM_Z.bat in your CMPROTO.dat file:
  144.  
  145.        1.  Using an alias (e.g. cm_z) as configured in 4DOS, only it and
  146.            the description are necessary.
  147.  
  148.               cm_z,Zmodem
  149.  
  150.            Your cm_z alias could be defined as:
  151.  
  152.               alias cm_z `dsz sz %%2`
  153.  
  154.        2.  The full drive\path and BAT extent are specified: 
  155.  
  156.               c:\util\CM_Z.bat,Zmodem via DSZ MobyTurbo
  157.  
  158.            Your CM_Z.bat definition could be as simple as:
  159.  
  160.               dsz sz %2
  161.  
  162.        3.  CM_Z.bat is found within the normally specified PATH, so the
  163.            command line can be abbreviated:
  164.  
  165.               CM_Z,Zmodem   MobyTurbo via DSZ
  166.  
  167.     As you can see, it all depends on your own system requirements.  The 
  168.     distribution archive contains sample protocol batch files. 
  169.  
  170.  
  171.                              ┌─────────────────────┐
  172.                              │      ATTENTION      │
  173.                              │       Sysops!       │
  174.                              └─────────────────────┘
  175.     
  176.  
  177.     For those of you running a system not directly supported by ChessMAGIC!, 
  178.     use QKDOOR2F.EXE by Chris Hall.  This utility converts your user files
  179.     from one format to another, enabling you to use ChessMAGIC! at once, with
  180.     little additional effort.  If you have trouble locating this utility,
  181.     call Decibel BBS.
  182.     
  183.     Qkdoor is easy to run and doesn't even need to be configured (you can 
  184.     delete the QKDOOR.CTL file -- it isn't required).  Run it where your user 
  185.     information files for the required node are located, using a simple 
  186.     command line: 
  187.     
  188.          qkdoor wwiv d:\cmagic\gap         {WWIV} 
  189.     
  190.     This will read in the user file data (in default area when run) and 
  191.     generate the DOOR.SYS file in your CMAGIC system directory (use whatever 
  192.     path suits your system setup). 
  193.      
  194.     After conversion to DOOR.SYS format, your ChessMAGIC! command line would 
  195.     be as simple as:
  196.     
  197.          cmagic door.sys
  198.     
  199.  
  200.     An example DOOR.BAT file when using this converter follows: 
  201.     
  202.          qkdoor wwiv d:\cmagic\gap 
  203.          d:
  204.          cd\cmagic
  205.          cmagic door.sys 
  206.     
  207.     
  208.     If you have trouble, PLEASE CONTACT US! 
  209.  
  210.